This program is $10 shareware. There is a $5 upgrade fee if you registered before 1/1/96, otherwise this upgrade is free to all registered users.
╥I filled up my disk in 20 minutes! Before Anarchie it would take me a good hour or more to download the same amount of stuff!╙ - Russell Baird
As seen on TV (MacNeil/Lehrer Show, May&October 1994)
As demoed at Apple╒s World Wide Developers Conference, May 1994
Second Place in the Best Scriptable Application category of the Everyday AppleScript¬ Contest, June 1994.
4.5 stars - MacUser Sep 1994 (and they were using v1.1.3!)
Outstanding Programming for a Shareware Product, USENet Macintosh Programming Awards, May 1995.
What Anarchie Does
Anarchie is an FTP (File Transfer Protocol) client for the Macintosh. It will let you browse FTP sites, upload or download files, or find them using an Archie or Mac Search. It requires System 7 and MacTCP 1.1 or later. System 7.5 and MacTCP 2.0.6 or later are both highly recommended.
FTP is the Internet standard for transferring files from machine to machine. There are thousands of public FTP sites with all of manner text documents, applications and pictures. In particular the Macintosh community has a couple of major FTP sites with huge collections of Macintosh software and information. The two major Macintosh sites are Info-Mac and UMich. The Info-Mac and UMich Macintosh FTP sites have mirrors (local copies) in most countries.
Features
Ñ Mac Search
Ñ Tips Window
Ñ Folder download
Ñ╩Apple Guide (thanks to Quinn!).
Ñ╩Internet Config support including post processing.
Ñ SIVC support. (Simple Internet Version Control.)
Ñ╩Drag Manager support.
Ñ╩AppleScriptable and Recordable.
Ñ╩Firewall support (SOCKS and Proxy FTP, but NOT CERN Proxy Web).
Ñ╩MacBinary uploads and downloads.
Ñ╩SITE INDEX support.
Ñ╩Archie query support.
Ñ╩Connectionless FTP.
Ñ╩Comes with bookmarks to many popular sites.
Ñ╩Fetches files from list windows with just a double-click.
Ñ╩Supports UserLand╒s MenuSharing.
Using Anarchie
Anarchie is spelled that way, only the first letter is capitalised, and is pronounced ╥Anarchy╙, not ╥An archie╙.
If you have System 7.5 or later, you can find out more useful information by using the Anarchie Guide: launch Anarchie and choose Anarchie Guide from the help menu (the ? in the top right hand corner of your screen).
Preferences
Anarchie uses Internet Config to manage some of the preferences it shares with other Internet applications like NewsWatcher or NetPresenz. If you haven╒t already configured your Internet Config preferences, you should do that first before you start Anarchie. Launch Internet Config (which is included with this package) and go through each of the panels in turn and fill in your details (in particular you should fill in your Email address, configure your fonts and select your preferred Info-Mac, UMich and archie servers). Save that and quit Internet Config. Anarchie╒s use of Internet Config is described in more detail in a later sections (in particular see the section ╘Internet Config╒).
If you do not fill in your E-Mail address in Internet Config Anarchie will keep asking you to run Internet Config. Anarchie depends on the default file mappings provided by Internet Config so you must run Internet Config.
Now you can launch Anarchie. Although Anarchie has some preferences of its own, you can pretty much ignore them for now. If you are behind a company firewall, then you may need to read the section on Firewalls before continuing.
FTP
The main purpose of Anarchie is to allow you can browse or manipulate FTP sites.
To get started, choose FTP╔ from the FTP menu. This presents you with a window allowing you to type in the name of the machine you want to FTP to (eg ftp.share.com), as well as an optional path, username and password. The path specifies which file or directory on the FTP site you wish to be fetched or displayed (eg peterlewis/). The username and password specify who to log in as. If you leave both of these blank, Anarchie will log in anonymously and supply your Email address (as configured in Internet Config) as your password.
You can also paste URLs like <ftp://ftp.stairways.com/stairways/> into this window and Anarchie will fill out the fields for you. URLs are covered in more detail in the ╘URLs╒ section.
If you know part of the name of the file which FTP site it is located on, then you may be able to use the Site Index feature. Click the Site Index radio button (or press command-4) and then type in the machine name in the machine field, and the name you want to search for in the Index field (eg anarchie) and click the Index button. Unfortunately, not all FTP sites support indexing, so some sites will return an error, or always return ╥Nothing Found╙.
Most of these actions will result in a window showing the progress of the listing, and when it is complete and new window listing all the files in the directory will show up. If the listing fails for some reason, you can retry by clicking the Retry button, or if you want to change something (if you made a mistake when you typed the machine), click the Edit Retry button. (The control key almost always works like this, turning a direct action into an edit action, allowing you to make changes and then continue.)
Previous to version 1.5 of Anarchie, the option key had the effect that the control key now has. The option key now means ╥close the parent window╙ just like it does in the Finder.
If you click on the information fields in the progress window (like Time Left), they will cycle through alternative displays.
The most common reason for FTP failures is that the FTP site is too busy to handle any more users at this time. You can usually see this by looking in the Transcript window (described in more detail later). It doesn╒t really help the situation for you to just keep clicking the Retry button until it gets through. A better solution is to look for the file elsewhere. Anarchie comes with a list of several dozen UMich and Info-Mac mirror sites (a mirror site is one that contains the same files as the original site, designed exactly to get around this problem of the servers being too busy).
The window that shows up listing the files in the directory (or the files found by the index command) is called a Listing Window and it described in detail in a later section which also describes more FTP commands.
Finding Files on Internet
The sections discusses Anarchie╒s built in search methods for finding files on the Internet.
Mac Search
New in Anarchie v2.0 is Mac Search. Because of the increasing unreliability of Archie servers Stairways Shareware and Ambrosia are hosting a server on the Internet which will perform searches of the Info-Mac and UMich file listings.
Choose Mac Search╔ from the File menu and type in what you want to search for in the Find field. You can choose a more complicated search, such as patterns which let you put ? and *╒s in your search (just like MS-DOS or Unix file names) or a regular expression search, but for the most part a simple substring search will do the trick. (Note that the search is not case sensitive.) Click the Find button and Anarchie will query the server. If any files match your search string Anarchie will return a listing window specifying their location on the UMich or Info-Mac mirrors you have specified as your defaults in Internet Config.
Archie
Anarchie also allows you to find files using Archie. Archie is a system of big servers that catalogue all the anonymous FTP sites and allow users to ask where files are stored. Unfortunately, they tend to be a bit behind the times and they are quite flaky, but they can usually find a starting point when you have no idea where a file might be. In general, if you know the file is on a UMich or Info-Mac mirror site (which is pretty much the case for almost any publicly distributable shareware or freeware Mac files), then you are better off using a Mac Search. If they are not on an Info-Mac or UMich mirror but you do know what server they are on, try a Site Index.
Choose Archie╔ from the File menu. Select a server from the popup menu and type in what you want to search for in the Find field. You can choose a more complicated search, such as patterns which let you put ? and *╒s in your search (just like MS-DOS or Unix file names) or a regular expression search, but for the most part a simple substring search will do the trick. Click the Find button and Anarchie will query the archie server. As noted above, the servers are a bit flaky at times, so you may want to repeat the query to a few other servers.
Archie queries do not work through firewalls. If you are behind a firewall, you can still use an FTP Index search, but not an archie search.
If your archie search returns some matches, they will show up in a Listing Window.
Site Index
If you know part of the name of the file and which FTP site it is located on, then you may be able to use the Site Index feature. Open a FTP╔ window, click the Index Search radio button (or press command-4) and then type in the machine name in the machine field, and the name you want to search for in the Index field (eg anarchie) and click the Index button. Unfortunately, not all FTP sites support indexing, so some sites will return an error, or always return ╥Nothing Found╙.
In Detail
The section goes into more detail about Anarchie╒s features.
Listing Windows
The Listing Window lists files and directories on various FTP sites. It is the primary focus of most actions in Anarchie. You can get a Listing Window in a number of ways, including those listed above (using Get..., Mac Search, Archie search or a bookmark). Once you have one, you can open other windows by double-clicking folders just like in the Finder. In fact, many Finder operations also work in a Listing Window (this is described in more detail in the Finder Shortcuts section).
There are a variety of actions you can perform using listing windows:
Ñ To download a file, simply double-click it or drag it to the Finder.
Ñ To download a folder drag it to the Finder. If you double click on the Folder it will open the Folder, not download it.
You will need the Drag Manager installed to allow dragging. We recommend installing System 7.5 to get the most out of Anarchie.
Ñ To view a text file in your favourite editor (as configured in Internet Config), select the file in the Listing Window and choose View Selection from the FTP menu.
Ñ To upload a file, choose Put╔ from the FTP menu, or drag it to the listing window from the Finder.
Ñ To rename a file or directory, select it and then choose Rename╔ from the FTP menu and type in the new name.
Ñ To make a new directory in the Listing Window listing, choose Make Directory╔ from the FTP menu and type in the name of the new directory.
Ñ To delete a file or a directory (which probably has to be empty), select it and choose Delete from the FTP menu.
Warning: There is no undo for this. Once you delete a file, the file is gone forever.
Many of the above commands modify the listing that the Listing Window is displaying. The listing window shows these changes in a variety of ways: uploads appear in bold and deleted files appear with a red line through them. This notation is used because the Listing Window shows a snap shot of the listing at the time you retrived the file listing. It makes no attempt to figure out if someone else is changing the directory, or if the above commands operated as expected (for example FTP servers often rename files or do other strange things when you upload files). If you want the Listing Window to be refreshed to display any changes you or anyone else has made, simply choose Retry (command-R) from the File menu.
You can use the View menu to sort the listing window by the various columns. You can also click on the column headers. If you choose a View when no listing window is displayed, it will be used as the default.
Download Windows
The download window gives information about how your download is progressing. You can click on the bottom three information fields to cycle them through:
Total, Transferred, Remaining
Bytes/Sec, Bytes/Min, Bytes/Hour
Time Left, Time, Start, Finish
Fetch compatibility mode turns the hopping Kangaroo in the download window on and off. It does not have any other effect. You can turn the Kangaroo on and off in the Preferences window.
Bookmarks
Anarchie comes with a large list of predefined bookmarks listing many interesting sites on the Internet. To use these, choose List Bookmarks from the File menu and Anarchie will open a Listing Window which lists most of the important Macintosh FTP sites.
To create your own bookmark, select the directory or file you want to create a Bookmark for and choose Save Bookmark╔ from the file menu. You can also hold the control key down and drag the file or directory to the Finder. If you place the new bookmark in the Bookmarks folder (which is in Anarchie╒s application folder) then it will show up when you choose List Bookmarks.
If you save any bookmarks in the Bookmarks folder, be careful not to delete them when you update to a new version of Anarchie!
Anarchie never saves passwords with bookmarks (although you can easily add a password to a bookmark yourself using BBEdit ╨ but then the security issues are on your head, not mine).
For more information on inserting usernames and passwords into bookmarks see the section ╘URLs╒ below.
You can edit existing bookmarks by holding down the control key while you double-click them, however saving them back will create a new bookmark unless you save them over the top of the existing bookmark.
You should not change the Bookmarks file that comes with Anarchie without good reason, because when a new version of Anarchie is released it will have updates of some of the sites and you will have to make your changes again.
Internet Config
Anarchie uses Internet Config to configure most of its settings. In particular it uses:
Ñ Your Email address as the anonymous password.
Ñ Your preferred Info-Mac and UMich mirrors ╨ if you paste a path like ╥/info-mac/whatever╙ into the FTP╔ window, it will be converted to a path to your preferred Info-Mac site (similarly for UMich paths)
Ñ Your Screen font (and if IC ever supports it, your Listing Font).
Ñ Your file mapping settings (to define types and application creators for downloaded files, as well as post processing options).
Ñ Your helper settings (the editor helper is used for the View Selection command).
Although it is a bit of a nuisance having your preferences in a different application when you only have one or two applications, it is a big win when you have five or more Internet applications. So take the time to set up your Internet Config preferences now and it╒ll save you some time when you download that next cool Internet application.
A growing number of applications have cool features which are only available if you have Internet Config installed. (Like command clicking URLs.)
As a pay back to Internet Config, Anarchie will also let you update the server lists (Info-Mac, UMich, and Archie servers), which means you always have the most current list. Choose Update Server List from the Edit menu and Anarchie will download the new lists and add them to your Internet Config settings. These lists change very slowly, so there is no need to do this more than a few times a year.
Manually Setting the Transfer Mode
You can temporarily set the transfer mode for uploads and downloads by selecting one of Text, Binary or MacBinary from the FTP menu. This transfer mode will apply until you change the setting, or until you quit. The Automatic transfer mode is the default mode. In Automatic mode Anarchie uses the settings in Internet Config to determine the mode to transfer the file.
Shortcuts
Anarchie╒s Listing Windows support many of the Finder╒s Shortcuts (in the Finder, choose Shortcuts from the Help (?) menu to read about these). In particular, you can:
Ñ sort the list by clicking the column headers.
Ñ drag files to or from the Finder.
Ñ type command-up arrow to open the parent window.
Ñ hold the option key down while opening a new window to close the old one.
Ñ close all windows using command-option-Close (then you can reopen some of them with the Log as described in a later section)
Ñ open a parent of the current directory by holding the command key down and clicking in the window╒s title.
Ñ typing the start of a name will select the first entry that starts with what you typed.
Also, pretty much anywhere you can do an action, if you hold the control key down Anarchie will let you edit the action first. For example, hold the control key down while double-clicking a file and Anarchie will let you edit the path (this is useful if you want to list a different directory or do an index search ╨ don╒t forget to set the radio buttons to listing or index).
Holding the option key down will either close the window at the completion of the action or it invokes an alternate behaviour dependent on the situation. For example, double clicking on an entry in a listing window while holding the option key down closes the list window as well as starting a new listing download. Holding option down in a FTP╔ window lets you copy a complete URL from the window. (The reverse of pasting into a FTP╔ window.)
URLs
Uniform Resource Locators (URLs) are the standard way of specifying locations on the Internet. Anarchie uses FTP URLs either as inputs (by pasting them in to the FTP╔ window) or as outputs (by selecting files or directories in listing windows and copying them).
An FTP URL looks like:
<ftp://user:password@host/path>
The ╥user:password@╙ is omitted for anonymous FTP. The path can start or end with a slash (/). If it starts with a slash (eg ftp://host//directory/), then it is an absolute path from the root of the FTP server╒s file system, otherwise it is relative to the default login location (which for anonymous FTP is often the root anyway). If the path ends with a slash, then it is a directory. Otherwise it is a file.
Netscape fails to understand absolute paths. Netscape will interpret the URL <ftp://machine//path/file> to be <ftp://path/file>.
<ftp://ftp.share.com/peterlewis/> is an example URL. It points to the machine ╥ftp.share.com╙ and the directory ╥peterlewis╙ relative to the default directory.
<ftp://ftp.share.com//ftp2/pub/peterlewis/0Programs.bin> is another example, this time it points to a file at the absolute path ╥/ftp2/pub/peterlewis/0Programs.bin╙
You can create Bookmarks with usernames and passwords by dropping the Bookmark on a text editor like BBEdit and inserting the username and/or password so that the URL conforms to the description given above.
Log
Anarchie logs all your listings, file transfers and searches. Anarchie does not save passwords in the log file. You can display this log using the Show Log command in the Window menu. This log is active, so you can double click an old entry in the log and it will fetch the file or directory listing. If you copy an entry from the log window and paste into a text editor Anarchie will automatically linewrap at 72 columns and surround the text by angle brackets.
Ñ Hold the control key down and double click on a an entry in the Listing Window to allow you to edit the information before retrieving the listing or file.
Ñ Hold the option key down while copying an entry to give a URL which is not line wrapped or surounded by angle brackets.
Remove entries by selecting them and choosing Clear from the Edit menu (Select All or Find all at once may be useful for cleaning out the log file).
Transcript
Anarchie keeps a transcript of all of the FTP sessions in the transcript window. If an FTP request fails and you don╒t know why, try looking in the transcript window for more information ╨ the server may have closed down or be temporarily overloaded, or the files you are after may have moved.
You can command click on URLs in the transcript window and they will be dispatched according to your Internet Config settings. (FTP URLs will be handled by Anarchie.)
Firewalls
A firewall is a machine that sits between your network and the rest of the Internet and limits the traffic that can pass between the two. The primary reason for this is to ensure that your internal network is secure from crackers on the Internet. Normally, a secure network is set up so that the firewall machine is the only machine that can send or receive packets from the Internet, and it can also send and receive packets from all the local machines. When a local machine wants to talk to a remote machine on the Internet, it communicates via the firewall machine using a firewall protocol. Normally this entails the local machine connecting to the firewall server and making requests and the firewall server then passes the request on to the remote machine and routes the replies back to you.
Anarchie supports two firewall protocols:
Ñ SOCKS is a standard TCP firewall protocol. It can work for any TCP connections (such as FTP, Finger, Gopher, Web, etc).
Ñ Proxy FTP is a pseudo standard FTP firewall protocol. You FTP to the firewall FTP server, and it FTPs the file for you.
Anarchie does not support the CERN proxy web server.
Archie queries will not work through any of the above firewalls.
Contact your network administrator for more information about what (if any) firewalls are in place at your site.
AppleScript
Most things you can do from the user interface you can also do by controlling Anarchie with AppleScript.
Many FTP commands take a long time to complete, so be careful to set the timeout or your script will terminate before the transfer is completed.
Example AppleScript:
tell application "Anarchie"
with timeout of 5 * 60 seconds
find "dehqx" server "archie.internic.net" matches 20 with window
store (file "HD:file") url "ftp://user:password@host/path"
Anarchie also supports the standard GetURL suite.
Check out the example scripts and Anarchie╒s dictionary for more information. More scripts are available at Anarchie╒s web page: <http://www.stairways.com/stairways/anarchie/>.
You╒re on your own when it comes to Frontier, we╒ve included some stuff from Leonard Rosenthol, but we have no idea what it does - cool and froody things we expect!
Raw FTP Commands
To send raw FTP protocol commands to the server, use the Send FTP Command. There are several things to note here:
Ñ╩Raw FTP protocol commands and Unix FTP client commands are not the same thing ╨ the FTP protocol has no get, put, ls, del, etc commands and if you try to send them, Anarchie will complain and if you ignore Anarchie the FTP server will complain.
Ñ Anarchie does not support allowing you to send file transfer or listing commands using the Send FTP Command.
Ñ╩Anarchie transparently opens and closes FTP sessions as required, so if you send an FTP command that changes the state of the FTP server and then Anarchie closes and reopens the FTP session, that state change may be lost.
Administrative Details
Getting Help
Anarchie has fairly extensive built-in help. If this manual is unclear to you, try the Anarchie Guide and Balloon Help from the help menu (the question mark in the top right hand corner of the screen). These can provide contextual help and walk you through most of the functions in Anarchie.
We don╒t guarantee any support, but we always answer our Email. If we don╒t answer your Email its because your message didn╒t get to us, or our reply bounced, so try again and include a valid Internet address if you can.
Please have a look over our web site before mailing support. Our Web site has lists of Frequently Asked Questions, documentation and tutorials on Anarchie- and our Web site is up all day every day. Our Web site can be found at:
<http://www.stairways.com/stairways/> or
<http://redback.cs.uwa.edu.au/peterlewis/www/>
Support E-Mail can be addressed to:
<support@stairways.com.au>
Limitations
Anarchie requires System 7 and MacTCP 1.1 or later. For large searches, large listings or many listings or searches or whatever, you may need to increase Anarchie╒s memory partition (use Get Info in the Finder to do this). To display FTP sites, Anarchie assumes the directory listing will look something like a normal Unix one, if it doesn╒t, it won╒t work. There is a document available on how Anarchie (and other programs) parse the LIST output, so if you are writing a server or client, let us know and we╒ll send you the document.
There may be problems with MS-Mail and/or Apple's CD-ROM driver v5.0.1. The latter seems to poll the SCSI bus while there is no CD in and these polls somehow lock the machine up if they happen during Anarchie transfers. RAM Doubler seems to be incompatible with serial networking (ARA, SLIP or PPP), and Anarchie seems to be very good at inducing a freeze when you are using RAM Doubler.
You may also have a problem over SLIP/PPP with your modem hanging up during a transfer if your modem init string does not contain &D0 (which tells it not to hang up if the buffer fills up).
Registering
This program is Shareware, which means if you use it, you should send us US$10. There is a $5 update fee if you registered before 1/1/96, otherwise this update is free to all registered users.
You can register one of two ways: on-line registration using a web browser, or off-line registration using the Register program.
Our online registration can be found at:
<http://kagi.direct.net/cgi-bin/register1.cgi?PL>
Or, using the Register program, you need to:
1. Get hold of a copy of the Register program.
2. Run the Register program and fill out the form.
3. Send it to Kagi Shareware.
About 1: Register is distributed with Anarchie and there is an Anarchie bookmark for Register in the NetPresenz distribution. You can also get Register from the following sites:
<ftp://mirrors.aol.com/pub/peterlewis/>
<ftp://ftp.share.com/peterlewis/>
<ftp://ftp.amug.org/pub/peterlewis/>
<ftp://ftp.HappySize.co.jp//pub/peterlewis/>
<ftp://redback.cs.uwa.edu.au/Others/PeterLewis/>
<ftp://nic.switch.ch/software/mac/peterlewis/>
..or there are download links on the following Web page:
About 2: You need to enter your name, email, postal address, and the shareware you wish to pay for. The form accepts many different payment methods such as: US Check, Money Order, Cash (in many different currencies), Visa, Mastercard, American Express, First Virtual, and Invoice (to be given to your accounts payable department).
About 3: Then either email the data generated by the registration program or print it and send it via postal mail or fax. Credit card information is encrypted by the Register program.
The address to send the completed form is output by Register when you Print or Copy the completed form. The addresses are:
Email: shareware@kagi.com
FAX: +1 510 652 6589
Snail-mail:
Kagi Shareware
1442-A Walnut Street #392-PL
Berkeley, California, 94709-1405
USA
Site License Registrations
World-Wide Source Code License: US$5000
World-wide license: US$2000
Universities or companies site license: US$500
Curtin University and the University of Western Australia are exempt.
Site licensing covers all machines in the organizations which are within a 100 mile radius of some central point.
There are no special educational dispensations: we have aimed to price our software at price which is affordable even to educational faculties.
Distribution
You may distribute this program any way you wish as long as you don't charge for it (except for reasonable download costs).
You MAY NOT DISTRIBUTE this program on any disk costing more than $5 without my explicit permission. You MAY NOT DISTRIBUTE this program on any CD without my explicit permission.
Warranty
This program should do what we╒ve described in this document. If it does not, you can simply stop using it. If you pay us, and within a year find that it does not do what we have describe here, then you can notify us and we will refund your money and cancel your license.
Fine Print
Peter Lewis and Stairways Shareware hereby disclaims all warranties relating to this software, whether express or implied, including without limitation any implied warranties of merchantability or fitness for a particular purpose. Peter Lewis and Stairways Shareware will not be liable for any special, incidental, consequential, indirect or similar damages due to loss of data or any other reason, even if Peter Lewis and Stairways Shareware or an agent of theirs has been advised of the possibility of such damages. In no event shall Peter Lewis and Stairways Shareware be liable for any damages, regardless of the form of the claim. The person using the software bears all risk as to the quality and performance of the software.
US Government:
If you are acquiring the Software and fonts on behalf of any unit or agency of the United States Government, the following provisions apply. The Government agrees:
(i) if the Software and fonts are supplied to the Department of Defence (DoD), the Software and fonts are classified as "Commercial Computer Software" and the Government is acquiring only "restricted rights" in the Software, its documentation and fonts as that term is defined in Clause 252.227-7013(c)(1) of the DFARS; and
(ii) if the Software and fonts are supplied to any unit or agency of the United States Government other than DoD, the Government's rights in the Software, its documentation and fonts will be as defined in Clause 52.227-19(c)(2) of the FAR or, in the case of NASA, in Clause 18-52.227-86(d) of the NASA Supplement to the FAR.
Acknowledgements
A huge thanks goes to Quinn for the amazing Anarchie Guide.
Thanks also go to Dmitry Boldyrev & Igor Livshits for the icons, and to various people on my beta list for their suggestions.
Thanks also to Chris W. Johnson and the folks at University of Texas at Austin for hosting the server lists fetched by ╥Update Server Lists╙. You might like to check out their archive at <ftp://ftp.utexas.edu/pub/mac/>, or at <http://wwwhost.ots.utexas.edu/mac/main.html> if you want a WWW interface.
And still more thanks to Andrew Welch and Ambrosia for hosting the Mac Search engine. You might like to check out their cool games at <http://www.AmbrosiaSW.com>.
Thanks also to Jean-Pierre Kuypers and our other translators for the various translations.
